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COMMUNICATING BETWEEN PROGRAMS HAVING DIFFERENT 
MACHINE CONTEXT ORGANIZATIONS 

Technical Field 

This invention relates, in general, to communicating 
5 between programs of a computing environment, and in 

particular, to a linkage design that allows programs with 
different machine context organizations to communicate with 
one another. 

Background Art 

10 Typically, one program will call another program in 

order to take advantage of the functionality of the other 
program. This enhances code reuse and reduces complexity of 
the calling program. 

However, previously, in order for one program to 
15 communicate with another program, the programs had to be 
architecturally compatible. That is, they had to have 
compatible machine context organizations. For instance, if 
one program used 32 -bit registers to save machine context 
information, then the other program had to similarly use 32- 
20 bit registers in order to retrieve and use the stored 
information . 

More recently, strides have been made to enable 
programs having different machine context organizations to 
communicate with one another. In one example, in order to 
25 accomplish this, multiple source code generations are 
produced. One code generation is targeted to one 

END9-2 000-0013-US1 -1- 



architecture, while another code generation is targeted to a 
different architecture. This causes code duplication, 
increases maintenance costs, and increases the risk of 
either introducing or incompletely fixing errors. 

Although some strides have been made to enable programs 
of differing architectures to communicate, there still 
exists a need for further enhancements to provide 
communication between programs having different machine 
context organi zat ions . 

Summary of the Invention 

Various shortcomings of the prior art are overcome and 
additional advantages are provided through the provision of 
a method of communicating between programs having different 
machine context organizations. The method includes, for 
instance, determining, at compile time, which savearea 
layout of a plurality of savearea layouts is to be used to 
save information relating to a calling program; and 
selecting, at compile time, a linkage service from a 
plurality of linkage services to be used in communicating 
between the calling program and a callee program. 

In one embodiment, the determining of the savearea 
layout is based upon one or more attributes of the callee 
program. One such attribute is, for instance, the size of 
one or more registers used by the callee program. In a 
further embodiment, the determining is also based on a 
target architecture mode. 
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In a further aspect of the present invention, the 
determining and selecting enables the provision of a source 
code that has at least one of the following: a reduced 
amount of dual path source code, natural parameter passing 
to/from a variety of caller types, and natural exploitation 
of a large architecture, where desired. The source code 
further comprises at least one common name usable in 
referencing one or more analogous fields in at least two 
savearea layouts of the plurality of savearea layouts to 
reduce dual path source code . 

System and computer program products corresponding to 
the above -summarized methods are also described and claimed 
herein . 

Advantageously, in one aspect of the present invention, 
multiple versions of object code can be produced from the 
same source code. Much of the source code is common, with 
just a portion of the code being different to support the 
different versions. Additionally, source code for many 
programs in the system can remain unchanged, if they do not 
need to exploit the new architecture. This is particularly 
useful when coding in assembler language, which requires the 
programmer to deal with linkage and savearea conventions. 

To enable the use of a common source code, the 
selection of a savearea layout and of a linkage service is 
performed at compile time. Further, fields that are common 
to multiple savearea layouts are referred to by a common 
name, which advantageously reduces the dual path source code 
that is needed. The present invention enables the 
coexistence of different savearea formats within a single 
compiled object code system. 
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Additional features and advantages are realized through 
the techniques of the present invention. Other embodiments 
and aspects of the invention are described in detail herein 
and are considered a part of the claimed invention. 



Brief Description of the Drawings 



The subject matter which is regarded as the invention 
is particularly pointed out and distinctly claimed in the 
claims at the conclusion of the specification. The 
foregoing and other objects, features, and advantages of the 
invention are apparent from the following detailed 
description taken in conjunction with the accompanying 
drawings in which: 

FIG. 1 depicts one example of a computing 
environment incorporating and using the communications 
capabilities of the present invention; 

FIG. 2 depicts one embodiment of a program 
attribute table employed in one aspect of the present 
invention; 



FIG. 3 depicts one example of a Type AB savearea 
layout used in accordance with the principles of the 
present invention; 



FIG. 4 depicts one embodiment of a Type C savearea 
layout used in accordance with the principles of the 
present invention; 
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FIG. 5 depicts one embodiment of a Type D savearea 
layout used in accordance with the principles of the 
present invention; 

FIG. 6 depicts one embodiment of the logic 
5 associated with determining the type of linkage 

services to be employed to communicate between 
programs, in accordance with the principles of the 
present invent ion ; 

FIGs. 7a-7c depict examples of implementing 

O 10 calling linkage services, in accordance with the 

ci 

^ principles of the present invention; 

4= 

~r* s FIGs. 8a-8c depict examples of implementing return 

mi 

.yg linkage services, in accordance with the principles of 

+= the present invention; and 

M 15 FIG. 9 depicts one embodiment of the logic 

associated with employing a full register capability of 
the present invention. 

Best Mode for Carrying out the Invention 



Hz 



In accordance with aspects of the present invention, a 
20 communications capability is provided which enables at least 
two programs (or modules) having differing machine context 
organizations to communicate with one another. The machine 
context organization includes, for instance, the size of the 
registers, the set of assembler instructions known to be 
25 available, the setup/format of the program status word 
(PSW) , and/or limits on addressable storage. 
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The communications capability pertains generally to a 
set of compatible architectures, e.g., a small architecture 
and a large architecture, which is upward compatible with 
the small architecture. The small architecture uses short 
5 registers, and the large architecture uses long registers, 
which are high-order extensions of the short registers in 
the small architecture (which are also addressable as short 
registers in the large architecture, for upward 
compatibility) . The short registers are equivalent to the 
10 low-order portions of the long registers. 

O One example of a computing environment incorporating 

m and using the communications capability of the present 

invention is depicted in FIG. 1. A computing environment 
100 is based, for instance, on the Enterprise Systems 
15 Architecture ESA/390 offered by International Business 

Machines (IBM) Corporation, Armonk, New York, as well as 
extensions thereto. In particular, computing environment 
100 supports, in accordance with an aspect of the present 
invention, multiple architectures, including a short 
§3 20 register architecture, and a long register architecture, as 
™ well as appropriate instructions to manipulate the 

architectures. ESA/390 is described in an IBM publication 
entitled "Enterprise Systems Architecture/3 90 Principles Of 
Operation," IBM Publication No. SA22-7201-06, July 1999, 
2 5 which is hereby incorporated herein by reference in its 
entirety. 

Computing environment 100 includes, for example, at 
least one central processing unit 102, a main storage 104 
and one or more input /output devices 106, each of which is 
30 described below. 
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As is known, central processing unit 102 is the 
controlling center of computing environment 100 and provides 
the sequencing and processing facilities for instruction 
execution, interruption action, timing functions, initial 
5 program loading and other machine related functions. The 
central processing unit executes at least one operating 
system 108 (e.g., VM/ESA offered by International Business 
Machines Corporation) , which is used to control the 
operation of the computing environment by controlling 
10 execution of other programs, controlling communication with 
peripheral devices and controlling use of the computer 
resources . 

Central processing unit 102 is coupled to main storage 
104, which is directly addressable and provides for high- 

15 speed processing of data by the central processing unit(s) . 
Main storage 104 may be either physically integrated with 
the CPU(s) or constructed in stand-alone units. In one 
example, resident within main storage 104 are operating 
system 108, a compiler 110 and one or more applications 

2 0 programs 112. 

Main storage 104 is also coupled to one or more 
input/output devices 106. These devices include, for 
instance, keyboards, communications controllers, 
teleprocessing devices, printers, magnetic storage media 
25 (e.g., tape, disks), direct access storage devices, and/or 
sensor based equipment. Data is transferred from main 
storage 104 to input/output devices 106, and from the 
input/output devices back to main storage. 



During processing of an application program (or other 
30 type of program) , the program may have occasion to call 
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another program. Thus, the programs need to be able to 
communicate with one another, even if the calling program 
and callee program have different machine context 
organizations. In particular, the callee may need to be 
able to access and change the caller's register state in 
order to receive input parameters and to return results. In 
order for programs to communicate with one another, a 
linkage design is utilized that provides correct linkage 
between the programs. In one instance, the design includes 
a program attribute table, which lists various programs and 
their associated attributes. In one embodiment, the table 
is created and consulted at compile time. (As used herein, 
compile includes, but is not limited to, assemble) . In 
particular, the program attribute table is, for instance, 
coded as a series of macros, which expand at compile time to 
record the attributes. Call, entry, and exit macros may 
then be executed at compile time to consult this table and 
generate code based on the attributes of the caller and 
callee and on the target architecture mode. 

One example of a program attribute table 200 is 
depicted in FIG. 2 and described herein. Program attribute 
table 200 includes one or more programs 202 listed by an 
identifier, such as a name, and one or more attributes 204 
associated with each program 202. One attribute provided is 
an indication of the width of the registers used by the 
program. This attribute has, for example, one of the 
following values: shortreg indicating the program uses 
short registers (e.g., 32 bit registers) and is restricted 
to using comparable sized instructions; longreg indicating 
the program uses long registers (e.g., 64 -bit registers); 
fullreg indicating the program uses the full size of the 
registers available. If longer registers are available, 
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then the program becomes a longreg program. On the other 
hand, if only shorter registers are available, then the 
program becomes a shortreg program. 

This attribute is employed, for instance, in 
5 determining which of a plurality of saveareas (e.g., 

storage) is to be used to hold information, including, for 
example, register contents, relating to a calling program 
when it calls a callee program. This information includes 
register content/machine context information used to restore 

10 the employed registers, upon return from the called or 

callee program, so that the calling program can continue to 
run as if the callee program did not change or use the 
registers (with the exception of values intentionally 
returned by the callee, which in one embodiment are returned 

15 by storing into the savearea) . 

In one embodiment, the savearea locations containing 
the register values are referred to by name in the source 
code. For instance, a callee uses a single named mapping 
(structure) to refer to the fields in the savearea. As an 

20 example, a shortreg callee uses a SAVBK mapping (e.g., 

registers SAVERO - SAVER1 5 ) , while a fullreg or longreg callee 
uses a SVGBK mapping (e.g., registers SVGRO - SVGR1 5 , or their 
low-order portions referred to as SVGR0LO-SVGR15LO) . In a 
small -architecture build (e.g., ESA/390) , the block called 

2 5 SVGBK has a physical layout similar to SAVBK. This allows a 
fullreg callee to use SVGBK names for the fields in the 
source code, which is common across builds (i.e., across a 
small architecture build (e.g., ESA/390) and a large 
architecture build (e.g., an extension to ESA/390 to 

30 accommodate large registers)). 
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Based on the attribute of the callee and/or the caller, 
there are three possible savearea layouts, in one 
embodiment. One type of savearea layout 300 is described 
with reference to FIG. 3. Savearea layout 300 (referred to 
5 herein as Type AB Savearea) is used when the caller and 

callee employ short registers. It includes, for example, a 
header 3 02 providing information relevant to the savearea 
and/or caller/callee ; a plurality of short registers 304 for 
storing information; and a work area 306 for use by the 
10 callee as temporary storage. For the Type AB Savearea, Type 
A refers to a shortreg callee' s view, and Type B refers to a 
fullreg callee' s view in the small architecture build. 

Another type of savearea layout 400 (referred to herein 
as Type C Savearea) is used when the caller attribute is 

15 longreg or fullreg in the large architecture build, but the 
callee attribute is shortreg. This type of savearea layout 
includes a header 402; low-order registers 404 (e.g., 
registers SAVER0-SAVER15) , a work area 406; and high-order 
registers 408. In one example, the high-order registers are 

2 0 managed by linkage services and are not referenced by the 
callee program. 

A further type of savearea layout 500 (FIG. 5) 
(referred to herein as the Type D Savearea) is used when the 
callee' s attribute is longreg or fullreg in the large 

25 architecture build, and the caller's attribute is any of the 
possibilities. Savearea layout 500 includes, for instance, 
a header 502; a set of contiguous large registers 504 (e.g., 
registers SVGR0HI/SVGR0LO through SVGR15HI/ SVGR15LO) and a 
work area 506. It should be noted that, in this embodiment, 

30 Type B Savearea and Type D Savearea can be referenced using 
common names for fields present in both savearea layouts. 
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For instance, in the SVGBK, the same name is used for the 
entire (short) register in Type B as for the low-order 
portion of the large register in Type D. 

The provision of an attribute that indicates the width 
5 of the registers used by a program and the provision of 

various savearea layouts enable the communications linkage 
between a caller program and a callee program to be 
determined at compile time. This is due, at least in part, 
to the static nature of the attributes of the programs. 

O 

yg 10 One embodiment of the logic run at compile time to 

W classify the type of linkage service needed is described 

£ with reference to FIG. 6. As described below, the linkage 

M service is selected based on the architecture mode for which 

*2 the program is being compiled (e.g., large or small) and the 

E = 15 attributes of the caller and callee. As examples, this 

O logic may be included within a compiler, or within macro 

yj 

logic contained in the source code for an operating system, 
application program or elsewhere. 

Referring to FIG. 6, initially, a determination is made 
20 as to whether the target architecture is a small 

architecture (e.g., 32-bit) or a large architecture (e.g., 
64-bit), INQUIRY 600. If the target architecture is a small 
architecture, then a savearea having short registers (see 
FIG. 3) is used and the linkage service corresponding to the 
25 shortreg attribute is selected for saving and restoring 
register contents, STEP 602. This linkage service is 
referred to herein as Type AB, which corresponds to Type AB 
savearea layout and is further described below. (As is 
known, registers in a savearea refers to register values or 
30 contents relevant to a particular context (point of 
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execution, e.g., at the point a caller invokes a callee) 
residing in the savearea) . 

However, if the target architecture is a large 
architecture, INQUIRY 600, then a further determination is 
5 made as to the attribute of the callee, INQUIRY 604. If the 
callee' s attribute is short registers, then a further 
determination is made as to the caller's attribute, INQUIRY 
606. If the caller's attribute is also short registers, 
then once again Type AB savearea layout and linkage service 
10 is selected, STEP 602. On the other hand, if the callee 
mode is short registers, but the caller mode is full 
registers or long registers, then a Type C linkage service 
is selected, which is described below, STEP 608. 

Returning to INQUIRY 604, when the callee 's attribute 
15 is full registers or long registers, then a Type D linkage 
service is selected, regardless of the caller's mode, STEP 
610. This type of linkage service corresponds to the Type D 
savearea layout . 

The different types of linkage services are described 
20 in further detail with reference to FIGs . 7a-7c and FIGs. 

8a-8c. In particular, the calling linkage services in which 
information is saved in the designated registers of the 
savearea are described with reference to FIGs. 7a-7c, and 
the returning linkage services in which information is 
25 restored are described with reference to FIGs. 8a-8c. In 
one embodiment, compile-time logic selects one of the 
calling linkage services of FIGs. 7a- 7c to be executed at 
run time to perform the call, and that selected logic in 
turn determines the corresponding return linkage service 
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from FIGs. 8a- 8c to be executed at run time to perform the 
return . 

Referring to FIG. 7a, the calling linkage service for 

Type AB is described. The calling linkage service is 

5 responsible for saving the caller 1 s state in the 

corresponding savearea and passing control to the callee. 

Initially, the savearea is allocated, STEP 700. The 
size of the savearea is dependent on the source generation 
being produced. The process of allocating a savearea may 

10 simply involve adjusting a stack pointer, or it may be a 

more complex operation requiring use of some registers. In 
the latter case, as is common in the art, the caller's 
values in those registers may be staged into a fixed storage 
area private to this instantiation of the linkage service, 

15 and may then be transcribed from the fixed area into the 
savearea after the allocation is complete. Registers not 
needed to perform the allocation may be saved directly into 
the savearea . 

After allocating the savearea, the short registers are 
20 saved in the savearea, STEP 702, and the return service is 
set to Type AB, STEP 704. In one embodiment, a pointer to 
this return service is stored in the header of the savearea. 
This allows the proper type of return service for this 
savearea format to be invoked from generic exit logic in the 
25 callee. For example, a shortreg callee will automatically 
use a Type AB return service when returning to a shortreg 
caller, but a Type C return service when returning to a 
longreg caller. Subsequently, control transfers to the 
callee program, STEP 706. 
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The return linkage service for Type AB is described 
with reference to FIG. 8a. The return service is 
responsible for restoring the caller's state and passing 
control back to the caller. The return service, in one 
5 embodiment, uses the return service information stored in 
the header of the savearea in performing the transfer. 

In one implementation, the short registers of the 
savearea are restored, STEP 800. Thereafter, the savearea 
is deallocated, STEP 802, and the logic returns to the 

10 caller, STEP 804. The process of deallocating a savearea 

may simply involve adjusting a stack pointer or it may be a 
more complex operation requiring use of some registers. In 
the latter case, as is common in the art, the values to be 
restored for the caller in those registers may be staged 

15 into a fixed storage area private to this instantiation of 

the linkage service, and may then be restored from the fixed 
area after the deallocation is complete. Registers not 
needed to perform the deallocation may be restored directly 
from the savearea. 

20 Referring to FIG. 7b, the calling linkage service for 

Type C is described. (The Type C linkage service 
corresponds to the Type C savearea layout depicted in FIG. 
4.) Initially, a savearea of the appropriate size is 
allocated, STEP 708, and then the low-order registers (e.g., 

25 SVGR0LO-SVGR15LO) are saved in the savearea, as well as the 
high-order registers (e.g., SVGR0HI-SVGR15HI) , STEP 710. 
Thereafter, the return service is set to Type C in the 
header of the Type C savearea, STEP 712, and control 
transfers to the callee, STEP 714. 
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Referring to FIG. 8B, the return linkage service for 
Type C is described. Initially, the low halves and high 
halves of the savearea registers are restored, STEP 806, and 
then the savearea is deallocated, STEP 808. Thereafter, 
5 control returns to the caller, STEP 810. 



The Type C layout and linkage service is for the case 
of a longreg caller (or fullreg in the large architecture) 
invoking a shortreg callee. In principle, the shortreg 
10 callee should not disturb the caller's state in the high 

halves of the registers that need to be saved. However, in 
E3 one embodiment, the high halves are saved and restored for 

3l several reasons : 

r; 1) It avoids a rework of context -switching ( thread - 

yg 15 switching) logic to save the high halves, provided 

^ that all such logic remains in shortreg callees. 

q By saving the complete registers on a long-to- 

M short transition, it is ensured that they are 

£7 captured before the shortreg context switcher can 

O 2 0 lose them. 

2) It tolerates "scratch" usage of the high halves in 
shortreg routines. Such a routine takes care not 
to assume that the high halves are preserved 
across a downward call; however, a longreg callee 
25 to this routine will not have its state corrupted 

by this activity. 



3) It ensures that the complete state of a longreg 
callee is captured in one place, which assists 
problem diagnosis. By contrast, if the high 
30 halves on a long-to-short transition were not 
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saved, then the diagnostician would have to 
reconstruct an ancestral longreg routine f s state 
from high halves and low halves in different 
saveareas or perhaps from high halves still in the 
5 machine registers and low halves in a distant 

savearea . 



In other embodiments, the high halves may not be saved. 

Referring to FIG. 7C, the calling linkage service for 
Type D is described. (The Type D linkage service 

10 corresponds to the Type D savearea layout depicted in FIG. 
5.) Once again, a savearea of the appropriate size is 
allocated, STEP 716, and then the long registers (e.g., 
SVGR0HI/SVGR0LO through SVGR15HI/ SVGR15LO) are stored 
contiguously in the savearea, STEP 718. Thereafter, the 

15 return service is set to Type D in the savearea header, STEP 
720, and control transfers to the callee, STEP 722. 



In order to restore the Type D savearea, the long 
registers are restored, STEP 812 (FIG. 8c) , and the savearea 
is deallocated, STEP 814. Subsequently, control returns to 
20 the caller, STEP 816. 



The above -described capability allows the use of 
multiple savearea layouts in, for example, a single product. 
In particular, different savearea layouts for different 
callees are provided within the same version of a product 
25 (e.g., the collection of object code produced for execution 
in a single target architecture) . Only one source code is 
needed to run the different savearea layouts. The source 
code selects the desired savearea layout based on the 
architecture and/or the caller/callee mode. 

END9-2 000-0013-US1 -16- 



In accordance with one aspect of the present invention, 
a full register attribute of a program is supported, which 
enables support of both short and long registers, depending 
on the architecture. Thus, large registers and new op codes 
5 are exploited if desired, while interface capability and 
support are maintained for shortreg callers. A common 
source code is employed for the different target 
architecture object programs. In particular, the use of a 
common, single source code is maximized, while also enabling 
10 target architecture specific code where desired to support 
new architecture, via conditional compilation logic. 

The fullreg capability allows common savearea field 
naming across different physical savearea layouts (e.g., 
savearea layouts Type AB and Type D) to accommodate the 

15 production of the appropriate object code for each 

architecture from common source code. In particular, a 
callee uses a single named mapping structure to refer to the 
fields in the savearea. This structure is referred to in 
the examples as SVGBK. In the small architecture build, the 

20 block which is called SVGBK actually has a physical layout 

similar to SAVBK. This allows a fullreg callee to use SVGBK 
names for the fields in source code, which is common across 
both builds. The compiler (or assembler) resolves this to 
the appropriate locations, which may be at different offsets 

25 in each build, for the layout used in each build. 

One embodiment for employing the fullreg capability of 
one aspect of the present invention is described in detail 
with reference to FIG. 9. The steps of this diagram are 
typically performed by a programmer when writing different 
30 portions of code, except for the area labeled assembly time 
logic, which is performed by a computer. 
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Initially, a determination is made as to whether the 
particular code section being written is specific to a 
target architecture, INQUIRY 900. If it is specific to a 
small architecture, then the chosen savearea layout is Type 
5 AB. 

Although the savearea layout is Type AB, the Type B 
names (SVGBK) are used. In particular, since this is a 
small architecture, the SVGBK 'LO' names are used. Further, 
the old op codes are used. This allows natural short 
10 register parameter passing with shortreg caller (in both 
builds) , and with fullreg caller in the small target 
architecture build. 

Returning to INQUIRY 900, if the code section is 
specific to a large target architecture, then the savearea 
15 layout selected is Type D, STEP 906. Since this is the 

large architecture, all of the SVGBK names may be used, as 
well as new op codes. This allows natural long register 
parameter passing with longreg callers (large build) , and 
with fullreg callers in the large target architecture build. 

20 If, however, the code section is not specific to the 

target architecture, INQUIRY 900, then the SVGBK c LO' names 
are used, as well as the old op codes, STEP 910. 
Additionally, a determination is made as to the nature of 
the target architecture of this assembly, STEP 912. If the 

25 target architecture is small, then the selected savearea 
layout is Type AB. The compile time logic automatically 
generates small format SVGBK offsets for the 'LO' names, STEP 
914. Again, this allows natural short register parameter 
passing with shortreg callers. 
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Returning to INQUIRY 912, if, however, the target 
architecture of this compilation is large, then the selected 
savearea layout is Type D, STEP 916. Thus, the compile time 
logic automatically generates large format SVGBK offsets for 
5 the 'L0' names. This allows short register parameter passing 
with all callers in both builds. 

The various coding modes described herein (e.g., 
architecture independent, small-only, large-only) may be 
combined into a single program. For example, a program may 
10 use a shortreg- style interface for exchanging information 

with its caller, so as to accommodate all types of callers, 
but may use longreg-style logic internally for its 
computations, and in invoking other programs. 

Further details associated with the fullreg capability 
15 of the present invention are illustrated below with the 
following assembly code fragments: 

Code Example 1: Assuming "common" (upwardly compatible from 

old/shortreg code; also usable from new fullreg and longreg 
code) interface parameter in Rl from caller: 

20 L R1,SVGR1L0 

SVGR1LO resolves to Type B layout offset for small 
target architecture build, but to Type D layout 
offset (right portion of SVGR1) for the large 
target architecture build. 

25 Code Example 2: Assuming architecture specific parameter (32 

bit in small target architecture build, 64 bit in large 
target architecture build) in R2 from caller: 
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AIF (&ARCHSMALL) 

Small target architecture build only code: 
L R2,SVGR2LO 

SVGR2L0 resolves to Type B layout offset because 
5 this code is only generated in the small 

architecture build. 

AELSE ( &ARCHLARGE ) 

Large target architecture build only code: 
, "Load -long" R2 , SVGR2 
10 Load 64 bit wide Register 2 from 64 bit wide field 

2 SVGR2 using an operation specific to the large 

yl architecture. SVGR2 resolves to Type D layout 

2T offset because this code is only generated in the 

y large architecture build. 

T 15 AEND ( &ARCHSMALL+ &ARCHLARGE ) 

Code Example 3 : Assuming a flexible input parameter in R3 , 

so that the routine may be called naturally with 32 bit 
parameter in the small target architecture build, and with 
either a 32 bit or 64 bit parameter, depending on the 
20 register style capabilities and preferences of the calling 
routine, in the large target architecture build. This 
fullreg technique allows service routines to be written 
which can be called by unchanged shortreg routines in both 
builds, and also by longreg/f ullreg routines in the large 
25 target architecture build, with natural register parameter 
interfaces in all cases. (Note: In the large target 
architecture, the selection between the two parameter widths 
is done, for instance, by a parameter option bit specified 
in a different register parameter, which is a 32 bit 
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parameter in both builds, such as demonstrated in Code 
Example 1 . ) 

The Example 3 code is as follows: 

AIF ( &ARCHSMALL ) 
5 Small target architecture build only code: 

L R3,SVGR3LO 

SVGR3L0 resolves to Type B layout offset because 
this code is only generated in the small 
architecture build . 

10 AELSE ( &ARCHLARGE ) 

Large target architecture build only code: 

Test parameter option bit in Rl to determine 
whether caller passed small or large R3 parameter 
TM SVGR1L0 , R3 PARMLARGE 
15 Is R3 input parameter large? 

BO R3 LARGE 

"Load- long- from- short" R3,SVGR3LO 

Load 64 bit wide Register 3 from 32 bit wide field 
SVGR3L0 using an operation specific to the large 
20 architecture, which converts a 32 bit operand to 

64 bits and loads it into a 64 bit register. 
SVGR3LO resolves to Type D layout offset because 
this code is only generated in the large 
architecture build . 
25 B HAVER3 

Rejoin common code at label HAVER3 . 
R3 LARGE EQU * 
"Load-long" R3 , SVGR3 
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Load 64 bit wide Register 3 from 64 bit wide field 
SVGR3 using an operation specific to the large 
architecture. SVGR3 resolves to Type D layout 
offset (only possibility, as field name SVGR3 does 
5 not exist in Type B layout) 

HAVER3 EQU * 



AEND ( &ARCH S MALL + &ARCHLARGE ) 

At this point, R3 contains a 32 bit parameter value in 
the small build, or a 64 bit parameter value (possibly 
10 converted from a 32 bit input parameter value) in the 

large build. Further conditional assembly logic would 
be used to process the R3 parameter. 

Described in detail above is a linkage design that 
enables programs having different machine context 

15 organizations to communicate with one another. In one 

example, the programs comprise a single executable module 
within a single computer; however, this is only one example, 
and the invention is not limited to such an example. The 
selection of the appropriate linkage services at compile 

20 time advantageously avoids more costly run-time testing in 
the call and return services. 



This design advantageously allows shortreg programs to 
continue unchanged, while allowing- all callees to use the 
savearea as desired, without knowing the attributes of the 
25 caller. 



In summary, some advantages of the present invention 
include compile-time selection of linkage operations 
(through services) based on caller/callee attributes versus 
runtime testing; use of a finite number of predefined 
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linkage services as opposed to a separate glue routine for 
each callee; use of single source to generate multiple 
object code in assembly language; and accommodation of 
register- intensive parameter-passing interfaces. 

5 

Although one example of a computing environment is 
described above, the invention is not limited to such an 
environment. The capabilities of the present invention can 
be incorporated and used with many types of computing 
10 environments, computing systems and/or platforms. The above 
are only offered as examples. For example, a computing 
environment having multiple systems, each having a different 
architecture, may employ aspects of the present invention. 

The use of the word "program" herein includes a portion 
15 of a program, a module, a whole program and/or any code that 
is to communicate with any other code. 

Further, although 32-bit registers and 64-bit registers 
are -g^er^as examples herein, the invention is not limited to 
such sizes. The invention is equally applicable to other 
20 architectural sizes. 



The present invention can be included in an article of 
manufacture (e.g., one or more computer program products) 
having, for instance, computer usable media. The media has 
embodied therein, for instance, computer readable program 
25 code means for providing and facilitating the capabilities 

of the present invention. The article of manufacture can be 
included as a part of a computer system or sold separately. 



Additionally, at least one program storage device 
readable by a machine, tangibly embodying at least one 
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program of instructions executable by the machine to perform 
the capabilities of the present invention can be provided. 



The flow diagrams depicted herein are just examples. 
There may be many variations to these diagrams or the steps 
5 (or operations) described therein without departing from the 
spirit of the invention. For instance, the steps may be 
performed in a differing order, or steps may be added, 
deleted or modified. All of these variations are considered 
a part of the claimed invention. 

M 10 Although preferred embodiments have been depicted and 

IH described in detail herein, it will be apparent to those 

HF skilled in the relevant art that various modifications, 

^ additions, substitutions and the like can be made without 

«D departing from the spirit of the invention and these are 

15 therefore considered to be within the scope of the invention 

Q as defined in the following claims. 

5 

it! 
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